home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / libraries / supralib.lha / SupraLib / readme < prev    next >
Encoding:
Text File  |  1995-03-08  |  3.3 KB  |  127 lines
  1.  
  2.  Supra -- Extension functions to dos, intuition and graphics library
  3.  =====
  4.  
  5.  Version 1.0 (8. Mar 1995)
  6.  © Copyright by Jure Vrhovnik. All rights reserved.
  7.  
  8. You can use Supra library in your own programs. You can redistribute
  9. the original archive as long as it remains unchanged. You may change
  10. the source code but you have to report all changes to the author of
  11. Supra library.
  12.  
  13.  
  14.  
  15. 0) PREFACE
  16. -------------
  17.  
  18.     First of all I must express an opinion of mine, which is sincere
  19. and makes me very happy that it is: "Despite the terrible situation of
  20. the Amiga computer, its soul still lives and it's even stronger than
  21. it has ever been before. And we've finally realized what this soul
  22. really is - it's Amiga users!"
  23.  
  24.  
  25.  
  26. 1) INTRODUCTION
  27. ------------------
  28.  
  29.     Supra is a collection of routines that can be considered as a
  30. small update to Amiga ROM libraries.
  31. Since computer programs grow complexier day by day programmers find
  32. it hard to cope with high level organization, and thus can't afford to
  33. use their time for implementing basic routines. That's why Amiga's
  34. libraries are so valuable - they help programmers to concentrate on
  35. developing larger projects and make the pieces of a puzzle bigger.
  36. However, Amiga libraries haven't been updated for quite a long time.
  37. The pieces of a puzzle haven't changed, but the puzzle grows along with
  38. more advanced projects.
  39.  
  40. This is my first release of supra functions. The collection is very
  41. tiny. However I hope this release will set a decent example that
  42. Amiga OS can and should be updated.
  43.  
  44.  
  45.  
  46. 2) DESCRIPTION
  47. -----------------
  48.  
  49.     Supra is a linked library which contains a few useful functions
  50. that are easy to use. A brief description of what it contains:
  51.  
  52.     o File copier
  53.     o Very easy but powerful recursive directory scanning
  54.     o Quick file type/existance checking
  55.     o Create an entire directory path (extension to CreateDir() )
  56.     o Image colour remapping (now you can show images in their real
  57.       colors on a workbench!)
  58.     o Obtain a list of best pens (extension to ObtainBestPen() )
  59.  
  60.  
  61.  
  62. Here is a list of function names:
  63.  
  64.     - FCopy()
  65.     - FileType()
  66.     - RecDirInit()
  67.     - RecDirNext()
  68.     - RecDirTags()
  69.     - RecDirFree()
  70.     - MakePath()
  71.     - ObtPens()
  72.     - RelPens()
  73.     - MakeNewImg()
  74.     - FreeNewImg()
  75.  
  76.  
  77. Every function is well documented and there are some useful examples
  78. included in this archive.
  79.  
  80.  
  81.  
  82. 3) INSTALLATION
  83. -----------------
  84.  
  85.     This release has only a header file for C language. You should
  86. do the following:
  87.  
  88. - copy lib/supra.lib library into your lib: directory
  89. - copy libraries/supra.h header file to include:libraries/supra.h
  90.  
  91.  
  92.  
  93. 4) USAGE
  94. -----------
  95.  
  96.     When you want to use any function from supra library with your
  97. C program you have to include a header file supra.h in your source:
  98.  
  99. #include <libraries/supra.h>
  100.  
  101. You'll have to link your object file with lib:supra.lib
  102.  
  103.  
  104.  
  105. 5) AUTHOR
  106. ------------
  107.  
  108.     I want Supra library to be as perfect as any rom libraries. I
  109. will be very happy for any comments about it (concerning source code,
  110. documentation, new ideas etc.). Programmers who have experiences in
  111. other languages, please contact me if you are willing to make header
  112. files in order to get supra available to other languages as well.
  113.  
  114. My address:
  115.  
  116.     jurev@gea.fer.uni-lj.si
  117.  
  118.     Jure Vrhovnik
  119.     Langusova 13
  120.     Ljubljana, 61000
  121.     Slovenia
  122.  
  123. my URL:
  124.     http://www.fer.uni-lj.si/~jurev
  125.  
  126.  
  127.